An Alert Destination resource captures a list of recipients that can receive alert notifications from the AquaLogic Service Bus. In typical system monitoring contexts, alerts generated by AquaLogic Service Bus bear significance to a finite set of users. In AquaLogic Service Bus, each Alert Destination resource may be configured to include a set of recipients according to a given context. Alert Destinations are used by Alert actions configured in the message flow, and also by SLA alert rules. An Alert destination could include one or more of the following types of destinations: Console, Reporting Data stream, SNMP trap, E-mail, JMS queue, or JMS topic. In the case of E-mail and JMS destinations, a destination resource could include a list of E-mail addresses or JMS URIs, respectively.
Alert Destinations can be re-used across alert configurations for services.
The following table lists the Alert Destination pages you can access from the Resource Browser and Project Explorer modules. The tasks and help topics associated with each are provided.
Table 6-1 Alert Destination Pages, Tasks, and Help Topics
Page
Associated Tasks
Help Topics
Summary of Alert Destinations
View a list of Alert Destinations. The Alert Destination name and Alert Destination path are displayed.
You can view a list of Alert Destinations in the Summary of Alert Destinationspage. If you have not yet created an Alert Destination, and want to do so, create a new alert Destination resource from the Project Explorer. To learn how, see Adding an Alert Destination. An Alert Destination is a destination address for alert notifications in AquaLogic Service Bus. To learn more, see Overview of Alert Destinations.
To List and Locate Alert Destinations
From the left navigation pane, click Alert Destinations from under Resource Browser. The Summary of Alert Destinations page is displayed. It shows the following information for each Alert Destination.
The path is the project name and the name of the folder in which the Alert Destination resides. It is a link to the project or folder that contains this resource. To learn more, see Viewing Project Details or Viewing Folder Details.
To locate a specific Alert Destination, do one of the following:
Filter by Alert Destination name. In the Name, and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the Alert Destination resides. The Alert Destinations matching the search criteria are displayed.
Sort the list. Ascending and descending arrow buttons indicate sortable columns—in this case, the Name and Path columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.
Note:
After a Search operation, click View All to display all Alert Destinations again.
You can create Alert Destination resources in the Create Alert Destination page. An Alert Destination is a destination address for alert notifications in AquaLogic Service Bus. To learn more, see Overview of Alert Destinations.
To Add a New Alert Destination
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Project Explorer. The Project View page is displayed.
Select the project to which you want to add the Alert Destination. You can add an Alert Destination directly to the project, or to a selected folder that resides in the project.
Note:
Click the name of a folder to select it. The Folder View page is displayed.
From the Project View or Folder View page, in the Create Resource field, select Alert Destination. The Create Alert Destination page is displayed.
In the Resource Name field, enter a unique name for this Alert Destination. This is a required field.
In the Resource Description field, enter a description for the Alert Destination.
Select any or all of the following destinations to be included in this Alert Destination resource:
Console: If you specify Console, alerts are sent to the ALSB console at run time. These alerts can be viewed in the Monitoring Dashboard
SNMP Trap: If you specify SNMP Trap, alerts are sent as SNMP traps, and can be processed by any third-party enterprise monitoring systems (ESM).
Reporting: If you specify Reporting, alerts are sent to the ALSB Reporting module and can be captured using a custom Reporting Provider that can developed using the Reporting APIs provider by AquaLogic Service Bus. This allows third-parties to receive and process alerts in custom Java code.
Add an E-mail recipient to the Alert Destination resource definition. To learn how to add an E-mail recipient, see Adding an E-Mail Recipient
Add a JMS Destination to the Alert Destination resource definition. To learn how to add a JMS Destination, see Adding a JMS Destination
To save the Alert Destination, click Save. If all the information you have provided is in the proper format, the new Alert Destination is included in the list of resources.
Note:
The new Alert Destination is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.
You can add multiple E-mail and JMS recipients to an alert destination. Before you add an E-mail destination, you should configure an SMTP Server (see Adding an SMTP Server), or a Javamail session in WebLogic Server (see Configure access to JavaMail in Administration Console Online Help).
Before you add an E-mail recipient, you must configure an SMTP Server resource, or have a Javamail session configured in WebLogic Server. If there are no SMTP Server resources or Javamail sessions available, configured, you cannot configure an E-mail Recipient.
To Add an E-mail Recipient
Select Send an alert via E-mail and click Add. The Add E-mail Recipient page is displayed.
In the Mail URI field, enter an E-mail recipient in the format:
mailto:username@hostname
This is a required field.
Note:
You can specify multiple email recipients, by entering the username and hostnames in a comma-separated list:
Only the first mail recipient needs to be prefixed with the text "mailto:".
In the SMTP Server field, select the name of the SMTP server for the outgoing E-mail. This field is not required if a mail session is selected in the next step.
In the Mail Session field, select an available mail session. This field is not required if an SMTP Server is selected in the previous step.
In the From Name field, provide a sender's name for the alert notification. This field is optional.
In the From Address field, provide a valid E-mail address. This field is required if a value for "From Name" field is specified.
In the Reply To Name field, provide a name to which a reply may be addressed This field is optional.
In the Reply To Address field, provide an E-mail address to which a reply may be sent. This field is required if a value for "Reply To Name" field is specified.
In the Connection Timeout field, enter the number of seconds a connection must wait fro a response from the server before timing out. The default value of 0
In the Request Encoding field, enter a character set encoding value. The default encoding value is iso-8859-1.
Click Save. The E-mail recipient is added to the list of E-mail recipients for this Alert Destination.
Adding a JMS Destination
To Add a JMS Destination
Select Send an alert to a JMS Destination and click Add. The Add JMS Destination page is displayed.
In the destination URI field, enter a JMS destination URI in the format:
jms://host:port/factoryJndiName/destJndiName
This is a required field.
Against Destination Type, select Queue or Topic as appropriate
Against Message Type, select Bytes or Text.
In the Request Encoding field, enter a character set encoding value. The default encoding value is UTF-8.
Click Save. The JMS destination is added to the list of JMS destinations to be included for this Alert Destination.
Viewing and Changing Details of Alert Destinations
The Alert Destination Detailspage displays detailed information about a specific Alert Destination. An Alert Destination is a destination address for alert notifications in AquaLogic Service Bus. To learn more, see Overview of Alert Destinations.
Click the Alert Destination name. The Alert Destination Details page displays the following information for the Alert Destination.
Table 6-3 Alert Destination Configuration Details
Property
Description
Resource Name
The name of this Alert Destination and the path in which it resides.
Last Modified By
The user who created or edited this Alert Destination.
Last Modified On
The date and time that the user created or edited this Alert Destination.
References
The number of objects that this Alert Destination references. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
Referenced by
The number of objects that reference this Alert Destination. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
Description
A description of this Alert Destination, if one exists.
General Configuration
Console: Yes or No, to indicate whether the Console option was specified as a destination for this alert when it was configured.
SNMP Trap: Yes or No, to indicate whether the SNMP Trap option was specified as a destination for this alert when it was configured.
Reporting: Yes or No, to indicate whether the Reporting option was specified as a destination for this alert when it was configured.
E-mail & JMS: Displays a list of E-mail recipients or JMS destinations, or both, if they were configured.
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session or click Edit to enter an existing session to make changes to the current configuration. To learn more, see Using the Change Center.
You can change your selection of the Console, SNMP Trap or Reporting setting.
To edit or delete an e-mail recipient or JMS destination, click the Edit button at the bottom of the page. Edit Alert Destination page is displayed.
To edit the e-mail destination, in E-mail click the edit icon under Options, for the e-mail recipient you want to edit. The Edit E-mail Recipient page is displayed. You can edit the information on this page according to information in Adding E-mail and JMS Recipients.
To edit the JMS destination, in JMS click the edit icon under options, for the JMS destination you want to edit. The Edit JMS Destination page is displayed. You can edit the information on this page according to information in Adding E-mail and JMS Recipients.
To delete one or all e-mail recipients or JMS destinations, click the delete icon under Options, for the e-mail recipients or JMS destinations you want to delete.
To update the Alert Destination, click Save. The Alert Destination is updated. The Summary of Alert Destinations page is displayed.
When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to discard the changes you have made so far in the current session.
You can delete Alert Destination resources from the Summary of Alert Destinations page. An Alert Destination is a destination address for alert notifications in AquaLogic Service Bus. To learn more, see Overview of Alert Destinations.
Note:
You cannot delete an Alert Destination if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon , a Delete icon with a red X is displayed for these resources.
To Delete an Alert Destination
If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.
From the left navigation pane, select Alert Destinations from under Resource Browser. The Summary of Alert Destinations page is displayed.
In the Options field of the Alert Destination you want to delete, click the Delete icon .
The Alert Destination is removed from the list.
Note:
If necessary, you can undo the deletion of this resource. To learn more, see Undoing a Task.
The Alert Destination is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.